AppendMenuItemText1

AppendMenuItemText

Appends a menu item to a menu.

pascal OSStatus AppendMenuItemText (
MenuHandle menu,
ConstStr255Param inString);

menu

A value of type MenuHandle . Pass a handle to the menu to which the menu item is to be appended.

inString

A value of type ConstStr255Param . Pass a Pascal string containing the text of the menu item to append. You can pass a string containing any characters, and these characters will be presented verbatim in the menu item.

function result

A result code. See Result Codes for the Mac OS 8.5 Menu Manager .

DISCUSSION

The AppendMenuItemText function appends the menu item containing the specified string to a menu, without evaluating the string for metacharacters, as the pre-Mac OS 8.5 Menu Manager function AppendMenu does. You may wish to use AppendMenuItemText if you have a need to present non-alphanumeric characters in a menu item.

The appended menu item appears at the end of the menu as an enabled item. If you wish to place the menu item elsewhere than at the end of the menu you should use the function InsertMenuItemText .

VERSION NOTES

Available with Mac OS 8.5 and later.